home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / telecom / 133 / c / time.man < prev    next >
Encoding:
Text File  |  1987-04-17  |  2.1 KB  |  51 lines
  1.  
  2. TIME                     ST Programmer's Manual                  TIME
  3.  
  4. NAME
  5.      time - time execution of a program
  6.  
  7. SYNOPSIS
  8.      time [-dl] prog [args...]
  9.  
  10. DESCRIPTION
  11.      Time measures the time required to execute a given program.
  12.  
  13. -d   If the option -d (lower case) is specified, time will assume
  14.      it was executed from the desktop, and hold the screen, waiting
  15.      for a keypress, after completion.
  16.  
  17. -l   If the option -l (lower case) is specified, time will list the
  18.      path and program name combinations as it searches for the program.
  19.  
  20.      The arguments -d and -l may be combined into -dl. The program to be
  21.      measured is entered on the command line normally, except that the
  22.      program name is preceeded by the program name "time " and possibly
  23.      by any of "time "'s optional arguments, d and/or l. The target program
  24.      is executed normally. After it is completed, time prints the elapsed
  25.      time since the program was initiated, then time itself exits. The
  26.      format of the time printout is MM:SS.FF where MM is the number of
  27.      minutes, SS is the number of seconds, and FF is the fractional part
  28.      of seconds in hundredths. Since time executes the target program via
  29.      a Pexec() function call, there will be slightly less memory available
  30.      for the target program than normal.
  31.      
  32. BUGS
  33.      The is a terrible lack of standardization in the use of the
  34.      "PATH=" environment variable. "time " defaults to the "PATH="
  35.      syntax of Micro C-Shell from Beckemeyer Development Tools.
  36.      Setting the compiler option "MWC" during compilation will change
  37.      the syntax to one compatible with Mark Williams C. There is a
  38.      last chance search of the current directory in case the original
  39.      COMMAND.TOS is being used.
  40.  
  41.      "time " reads the system 200hz counter rather than set up an
  42.      interrupt vector. This may cause the elapsed time to vary by
  43.      one or two hundredths of a second on identical executions.
  44.  
  45. AUTHOR
  46.      George R. Woodside           PPN 76537,1342
  47.      5219 San Feliciano Drive
  48.      Woodland Hills, Ca. 91364
  49.  
  50. Printed 01/09/87                                                1
  51.